textEncode

Type

function

Summary

Converts from text to binary data.

Syntax

textEncode(<stringToEncode>, <encoding>)

Description

Converts from text to binary data.

The textEncode function takes text, and returns it as binary data, encoded with the specified encoding.

The encoding is matched case-insensitively and most punctuation (such as "-") is ignored. This means that "UTF8", "utf-8", and "u.t.f.8" are all valid names to use for the utf-8 encoding. More information about this can be found on the Unicode Consortium Site.

It is highly recommended that any time you interface with things outside LiveCode (files, network sockets, processes, etc) that you explicitly textEncode any text you send outside LiveCode and textDecode all text received into LiveCode. If this doesn't happen, a platform-dependent encoding will be used (which normally does not support Unicode text).

It is not, in general, possible to reliably auto-detect text encodings so please check the documentation for the programme you are communicating with to find out what it expects. If in doubt, try UTF-8.

Parameters

Name	Type	Description
stringToEncode	string	Any string, or expression that evaluates to a string.
encoding	enum	The encoding to be used

Examples

textEncode("A","UTF-16")

put textEncode(field "output","UTF-8") into tOutput
put tOutput into url ("file:output.txt")

Related

function: textDecode, textEncode

Compatibility and Support

Introduced

LiveCode 7.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile